INTRODUCTION TO BAXTER 


UHCL | 
ROBOTICS 


T.L. Harman and Carol Fairchild Updated 2/08/2016 


BAXTER INTRODUCTION 


Baxter is a two-armed robot purchased for the “Robotics and Control System Laboratory” at the 
University of Houston Clear Lake (UHCL). Baxter is housed in Delta 125 which will be referred to 
in this report as “Baxter’s Lab”. The robot was built by Rethink Robotics and Baxter and its 
applications are described on the web site: 


http://www.rethinkrobotics.com 


The version of Baxter in Baxter’s lab is the research version which can be controlled via a 
workstation used to create programs and execute them on Baxter. Another version of Baxter is 
the manufacturing version that Rethink sells is trained by “showing” with no programming 
needed. For example, an operator moves Baxter’s arms and records positions and then replays 
the motion. 


Figure 1 Tom and Baxter in UHCL Lab D125 


This report describes the software and hardware elements of the research Baxter system 
including the workstation and its software and Baxter’s Network. It is NOT a User’s Manual for 
those wishing to run applications on Baxter. Another report Baxter User Guide will describe the 
use of Baxter and its standard applications called “Rethink Baxter Examples” provided by 
Rethink Robotics. Another report Baxter Guide for Advanced Users will describe how to write 
Baxter programs or scripts. However, anyone wishing to use Baxter should have a basic 
understand of the material in this present report. 4/17/2015 
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INTRODUCTION 


Baxter is a two-armed robot from Rethink Robotics in Boston, MA. The research version that we 


have at UHCL consists of a number of elements. This report will briefly describe each element 
and its use to control Baxter. Table 1 summarizes the components of a Baxter system. 


Baxter’s April 2015 version | Robot with two 7DOF arms and various sensors such 
Hardware as sonar and cameras. 
WorkStation v1.1.0 Workstation with Development System (SDK), 
SDK software Rethink Baxter Examples and APIs. 
IP: 172.29.64.201 
Baxter Simulator Gazebo and Movelt simulate Baxter. 
Baxter Software v1.1.0 Baxter’s internal software. 
Baxter Network Baxter - http://172.29.64.200:11311 
IP Address 


Table 1. Versions of Baxter's Hardware and Development System components 


ITEM VERSION USE 
Operating Ubuntu 14.04.2 | System Administrator — Create user accounts and 
System (OS) LTS download and maintain software. 
Trusty Tahr Users — file management and communication with 
Baxter through Terminal commands. 
BASH GNU bash, version | The shell is a program that takes typed commands 
4.3.11(1)release | from the keyboard and passes them to the operating 
(x86, 64-pc-linux- | system or ROS to perform. 
gnu) 
Robot Operating | "Indigo" Igloo A software package used for Robotic software 
System (ROS) development. It is the interface between the OS and 
Baxter. 
Python Python 2.7.6 The Rethink Baxter Examples are written in Python. 


Table 2. Versions of Software supporting Baxter 


BAXTER’S SYSTEM 


Baxter the Robot can be controlled from the workstation and the various programs supplied by 
Rethink Robotics. Figure 3 shows how the workstation and Baxter are connected. Baxter has his 
own IP address. 


The SDK interfaces with the Baxter Research Robot via ROS (Robot Operating System). Baxter provides a 
stand-alone ROS Master to which any development workstation can connect and control Baxter via the various 
ROS APIs. The ROS and the APIs will be described later in this report. 


Ubuntu Development Workstation 


= WorkStation IP address 


Baxter Research Robot 


Gigabit Ethernet 
Switch 


Baxter’s IP Address 


Figure 4 Overall Architecture of Baxter 


http://sdk.rethinkrobotics.com/wiki/Baxter Research Robot Software Developers Kit (SDK 


BAXTER’S HARDWARE 


This section describes Baxter’s basic specifications. Appendix I gives more details. Some useful 
details are found in the various patents that have been filed or awarded to Baxter. For example, 


http://www.google.com/patents/US20130345872 User interfaces for robot training 


- 


Condition ring 


Attention ring 
Display 
Work lights 


Navigator 
Lower front panel 
Waist 


Training cuff with parallel gripper 


oO ON! oe Nw 


. Training cuff with vacuum gripper 


10. Pedestal 


Figure 5 Baxter's Physical Structure 


The Pre-delivery Guide and the Hardware Specifications describe Baxter’s hardware: 


http://sdk.rethinkrobotics.com/mediawiki-1.22.2/1mages/9/94/BRR pre-delivery 131120.pdf 


http://sdk.rethinkrobotics.com/wiki/Hardware Specifications 


The Baxter Robot head display is a 1024 x 600 SVGA LCD screen capable of panning 180? and 


also nodding to acknowledge user input. Baxter's head has a pan joint and a single "Nod" action 


for movement. There is one camera, one red LED ring, one green LED ring, and 12 individual 


yellow LEDs along with 12 sonar transducers. http://sdk.rethinkrobotics.com/wiki/Head 


Some of the items in Figure 5 include: 
1. Condition Ring — A green lighted ring will show when Baxter is ready to work (after the 
internal computer boots up) 
2. Attention Ring — A ring of motion sensors that indicate the presence of a person or object 
3. Display — The screen with resolution of 1024 x 600 pixels can be used for display of 
pictures or images or show text during Baxter's operation. 


In the manufacturing version, the display shows Baxter's state when Baxter is being trained or 
is working. The operator uses the display to make selections via the navigator buttons in Figure 5 
and Baxter uses the display to communicate information to the operator. This is explained in the 
User's Guide for the manufacturing Baxter: 


http://mfg.rethinkrobotics.com/mfg-mediawiki-1.22.2/images/4/42/3.0.0 User Guide.pdf 


The following video shows a good example of training the manufacturing version of Baxter: 


https://www.youtube.com/watch?v=tW WKhp892Gk&feature-em-uploademail 


The training cuffs (8-9) in Figure 5 are explained in the section describing the "zero-g mode" 
later. They are used extensively in the manufacturing version of Baxter but also have uses for the 
research Baxter. The cuffs are used basically to move Baxter's arms without much resistance and 
also to open and close the electric gripper in certain operations. 


Electrically, Baxter uses standard 120VAC power. The robot power bus and internal PC both 
have “universal” power supplies and support 90 - 264V AC (47 - 63Hz). The current is 6A at 
120V AC or 720W maximum. 


Baxter's rear connections include the Power connector, Emergency Stop connection, USB port, 
Ethernet port, and Vacuum connection if a vacuum gripper is used. 


Figure 6 Baxter's External Connections 


Details of Baxter’s reach and workspace are described in the workspace guidelines in the Baxter 
Setup Document: http://sdk.rethinkrobotics.com/wiki/Workspace_Guidelines 


36.25" (92 cm) Pedestal shown 


56.3" 
(143 cm) 
Torso base to top of robot reach 


Figure 7 Side View of Baxter's Workspace 
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Baxter’s Internal Computer 
Processor 3rd Gen Intel Core 17-3770 Processor (8MB, 3.4GHz) w/HD4000 Graphics 
Memory 4GB, NON-ECC, 1600MHZ DDR3 


il 


V 
"A 


Ge 


Figure 8 Baxter's Internal Circuits 


Baxter's Field Service Menu (FSM) is used for setup during initial installation and other 
operations: http://sdk.rethinkrobotics.com/wiki/FSM 


“The Field Service Menu (FSM) is a pre-boot configuration menu that allows the user to do advanced tasks 
such as check network interface configuration, change the robot computer's hostname, and run low-level 


hardware checks." This feature is normally not used by a Baxter User except for special operations. 
The FSM appears on Baxter's display when activated. 


In Baxter's Lab, Baxter has his own IP address - http://172.29.64.200:11311. The details are 
presented in the document: http://sdk.rethinkrobotics.com/wiki/Networking 
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Baxter’s 7DOF Arms 


SO - Shoulder Roll 
e $1 - Shoulder Pitch 

*  EO- Elbow Roll 

* 1 - Elbow Pitch 

e WO - Wrist Roll 

e W1- Wrist Pitch 

e W2 - Wrist Roll 


Figure 9 Baxter's Arm and Joint Designations 


Baxter’s 7 Degree of Freedom (DOF) compliant arms are described in several documents on the Rethink 
Robotics WEB site: 


http://sdk.rethinkrobotics.com/wiki/Arms 
http://sdk.rethinkrobotics.com/wiki/Hardware_ Specifications 
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The figure shows the arm and the end effector which is an electric gripper in this case. Rethink 


recommends: “Periodic recalibration will ensure that position and force sensors work well and the robot arms 
can move smoothly and accurately.” 


http://sdk.rethinkrobotics.com/wiki/How often does baxter need to be calibrated 


For more advanced users familiar with ROS, the calibration procedure is described in the document: 


http://sdk.rethinkrobotics.com/wiki/Arm_ Calibration 


Zero-G Mode 


The zero-g mode allows control of Baxter’s arm without resistance from the arm’s motors. The mode is 
described in the document: 


http://sdk.rethinkrobotics.com/wiki/Zero-G Mode 


According to the description: “Zero-G mode can often be confused with the mode obtained by disabling the 
gravity compensation torques. By default, the gravity compensation torques will always be applied when the 
robot is enabled. In Zero-G mode, the controllers are disabled and so the arm can be freely moved across. In 
this case, the effect of gravity would be compensated by the gravity compensation model applying gravity 
compensation torques across the joints, there would be no torques from the controllers since they would not be 
active, and so the arm can be moved freely around, hence the name.” 


“The Zero-G mode can be enabled by grasping the cuff over its groove as below 


Figure 10 Baxter's Cuff to Enable Zero-G mode 
References for the Arms and the Series Elastic Actuators: 


The arms have a compliance which allows close and safe human interaction with Baxter. This is 
accomplished through a series of elastic actuators incorporated into all 14 arm joints. 


Part Manipulation using Sensing and Force Control — Alex Goodwin, Rethink Robotics 
“Alex described Rethink Robotics flagship product, Baxter, as a robot falling into a new category 
of robotics defined by industry requirements for dexterity. As such, the Baxter platform offers 
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direct manipulation as well as integral vision and force sensing of two highly dexterous 7 DOF 
arms. This new technology is designed to work alongside people performing human-scale tasks 
at human cadence, eliminating the need for safety cages. This is accomplished through a series of 
elastic actuators incorporated into all 14 arm joints.” NISTIR 7940 

Dexterous Manipulation for Manufacturing Applications Workshop June 2013 


http://www.nist.gov/el/isd/upload/NIST-IR-7940. pdf 


A.I. Technical Report No. 1524 January, 1995 


Series Elastic Actuators, Matthew M. Williamson 


http://dspace.mit.edu/bitstream/handle/1721.1/6776/AITR-1524.pdf?sequence=2 


Baxter’s Electric Gripper 
The UHCL Baxter has an electric gripper. Installation is described in the document: 


http://sdk.rethinkrobotics.com/wiki/Electric_Gripper_Installation 


Figure 11 Baxter's Electric Gripper 


The gripper has two “fingers” with removable inserts to allow different configurations of the 
gripping surface. According to the specifications” 


Positional Accuracy +/- 5 mm 

Max Payload (including end-effector) 5 lb / 2.2 kg 

Gripping Torque (max) 10 lb / 4.4 kg 

Gripper maximum opening width can be adjusted by repositioning the "fingers" as 


described in the document: 
http://sdk.rethinkrobotics.com/wiki/Electric Gripper Installation 
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“Each hand has a 3-axis accelerometer located inside the cuff, in the same plane as the gripper 
electrical connection header. The positive z-axis points back 'up' the arm (towards the previous 
wrist joint, wO). The positive x-axis points towards the camera, and the y-axis points towards the 
cuff buttons, using standard Right-Hand-Rule notation” as described in the reference: 


https://github.com/RethinkRobotics/sdk-docs/wiki/API-Reference 


This reference is for advanced users as it details the API and ROS topics for the Baxter 
hardware. 
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Baxter’s Camera and Sensors 


Baxter has a camera in each cuff as well as an Infrared (IR) sensor to measure distance. 


Figure 12 Baxter's camera and IR Sensor in the Cuff 


The figure shows the end of the cuff with the cuff camera and the IR ranging sensor. 


The Camera Specifications are as follows: 


Max Resolution 1280 x 800 pixels 
Effective Resolution 640 x 400 pixels 
Frame Rate 30 frames per second 
Focal Length 1.2mm 


Infrared (IR) Range Sensors in each cuff have a range of 1.5 — 15 in / 4 — 40cm 


The documents describe the cuff and the sensors in more detail: 


http://sdk.rethinkrobotics.com/wiki/Arms 


http://sdk.rethinkrobotics.com/wiki/API_Reference#Sensors 


A Experiments in Baxter’s lab made several things clear: 


1. The accuracy of the distance measurement using the IR sensor varied depending on the 
surface below the sensor. 


2. Note from the figure of the cuff camera that the center of the gripper is offset in both the x 
and y direction if we consider the z direction pointing up the arm when the gripper is in line with 
the first joint. Thus, if the camera is used for positioning the gripper over an object to be picked 
up, the offsets must be considered. 
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This article is a simple discussion of IR and sonar sensors: 


http://www.societyofrobots.com/member_tutorials/node/71 


Generally, a black object that is not reflective will absorb some of the IR and the distance 
measurement might be in error. A white table top, for example, reflects the IR very well and 
Baxter’s IR sensor calculated the distance from the table accurately and repeatedly. 
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SDK SOFTWARE FOR BAXTER 


The next Figure shows the elements of software loaded on the workstation to download software 
or operate Baxter. Notice the Baxter Interface, Examples and Tools software modules. These will 
be described in detail in another report Baxter User 5 Guide which will describe the use of 
Baxter and its standard applications called “Rethink Baxter Examples" provided by Rethink 
Robotics. 


Organization 


SDK vO.7.0 


Github Architecture 
Rethink Robotics Inc. 


Baxter Research Robot 
github.com/RethinkRobotics 
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Figure 13 Baxter's SDK Software 

BAXTER SIMULATORS 

Movelt 

The Rethink document presents a detailed tutorial about the use of Movelt. 


http://sdk.rethinkrobotics.com/wiki/Movelt Tutorial 


“Movelt! motion planning framework provides capabilities including Kinematics (IK, FK, Jacobian), Motion 
Planning (OMPL, SBPL, CHOMP) integrated as Movelt! plugins, Environment Representation (robot 
representation, environment representation, collision checking, contraint evaluation), execution using 
move_groups, benchmarking, warehouse database for storage (scenes, robot states, motion plans), a 
C++/Python API and more!” 


In short, Movelt allows path planning with obstacles in Baxter’s path and then execution of the 
path on the “real” Baxter. 


A very useful video from Rethink explains the use of Movelt. 


Baxter Research Robot Movelt! Tutorial 


rethink 6D 


robotics 


Rethink Robotics 
https://www.youtube.com/watch ?v=1Zdkwym42P4 


Figure 14 Movelt Simulation of Baxter 


To use Movelt, the Rviz (ROS visualization) window will then open showing Baxter with 
interactive markers. The markers are used to move Baxter’s arms in the simulation. 


" rviz (ROS visualization) is a 3D visualizer for displaying sensor data and state information from ROS. Using 
rviz, you can visualize Baxter's current configuration on a virtual model of the robot. You can also display live 
representations of sensor values coming over ROS Topics including camera data, infrared distance 
measurements, sonar data, and more.” 
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Baxter Simulator Gazebo 


The site http://sdk.rethinkrobotics.com/wiki/Baxter_Simulator describes the Baxter Simulator. It 
is used to model Baxter and environments. Rethink defines Baxter’s characteristics in the form 
of a URDF (Unified Robot Description Format). Baxter automatically builds his URDF on boot- 
up. It is accessible by ROS utilities, Gazebo and other simulators. 


“Gazebo is a multi-robot simulator in a 3-dimensional world. It comes with advanced plugin interfaces that can 
be used to simulate the sensor feedback and plausible interactions between objects. There are standard 
models available within gazebo that can be used with custom models." 


Figure 15 Baxter Simulator 
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V-REP (Virtual Robot Experimentation Platform) 


© 


COPPELIA 
ROBOTICS 


Marc Freese 


“The video shows the Baxter robot in the V-REP robot simulator ( http://www.coppeliarobotics.com ). It 
illustrates several of V-REP's features: simple scene composition, physics, motion planning, inverse 
kinematics, etc. The video shows the Baxter robot doing some object manipulation. The simulation uses 
V-REP's built-in motion planning and inverse kinematics algorithms. The Baxter CAD data is courtesy of 
Rethink Robotics.” 


https://www.youtube.com/watch?v=PHuQZDp8kt8 


Figure 16 VREP Simulation of Baxter 


The User's Manual is available at this site: http://www.coppeliarobotics.com/helpFiles/index.html 
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ROBOT OPERATING SYSTEM (ROS) 


ROS is sometimes called a “meta operating system" because it performs many of the functions 
of an operating system. One of its main purpose is to provide communication between the user, 
the Ubuntu OS and of course Baxter. As with any operating system, the benefit of ROS is the 
hardware abstraction and low-level control of Baxter without the Baxter user knowing all of the 
details of the robot. For example, to move Baxter's arms, a command to ROS is issued and ROS 
communicates with the scripts! in Python written by the Rethink designers to cause Baxter to 
respond as commanded. Baxter is defined to ROS by the designers at Rethink Robotics in 
various ways describe later. 


For a little history: 


http://en.wikipedia.org/wiki/Robot Operating System 


“ROS was originally developed in 2007 under the name switchyard by the Stanford Artificial 
Intelligence Laboratory in support of the Stanford AI Robot STAIR project. From 2008 until 
2013, development was performed primarily at Willow Garage, a robotics research 
institute/incubator. During that time, researchers at more than twenty institutions collaborated 
with Willow Garage engineers in a federated development model. 


In February 2013, ROS stewardship transitioned to the Open Source Robotics Foundation. In 
August 2013, a blog posting!” announced that Willow Garage would be absorbed by another 
company started by its founder, Suitable Technologies. The support responsibilities for the PR2 
created by Willow Garage were also subsequently taken over by Clearpath Robotics". 


The link to Clearpath Robotics is http://www.clearpathrobotics.com/ 


Our Baxter now (2015) uses the Indigo release of ROS: 


ROS Indigo Igloo is the eighth ROS distribution release and was released July 22nd, 2014. Quote 
from: http://wiki.ros.org/indigo 


t The Python scripts in turn call various software elements including the Baxter APIs (application programming 
interfaces) that cause the actual motion of Baxter's arms. 
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ROS Terms 


Before a beginner even opens a web tutorial or book or sees a ROS video, it is helpful to learn a 
few terms that pertain to ROS. These terms describe the main components of a ROS system. 


Table 2. ROS Useful Terms 


Item Type Comment 

Repositories | Asoftware repository | http://en.wikipedia.org/wiki/Software_repository 
is a storage location 
from which software GitHub is used to download the ROS packages used 
packages may be by the Baxter system: 
retrieved and installed | http://sdk.rethinkrobotics.com/wiki/Workstation_Setup 
on a computer. 

Packages Contains files to A package typically contains source files and 

allow execution of executable scripts that can be BASH, Python, or other 
ROS programs code. 
Manifest Information about a The manifest defines properties about the package 
package such as the package name, version numbers, authors, 
maintainers, and dependencies on other packages. 
Services Allows Used by nodes to communicate with other nodes and 
communication request a response. 
between nodes. 

Nodes Processes that Executable code written in Python or C++ usually. 

execute commands. Python nodes use the client library rospy 

ROS Master | Registers the name Allows nodes to communicate. Nodes can be in 

and location of each | different computers. 
node. 

Messages Data sent between Messages are "published" by a node and "subscribed 

nodes. to" by another node. 

Topic Name of a message. For example, Baxter’s cameras “publish” the image 
they receive as a topic with a name that indicates it is a 
camera image. 

Bags Data storage for Used to save and playback data such as sensor data. 

messages. 
Table 3 ROS Terms 
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Figure 17 Example ROS nodes from Clearpath Robotics 


Computer on the Robot Laptop 


Reqisiration Regrmtration 
ww = 
Data 


ROS Tutorials and Books 


A large number of tutorials are available at the ROS.ORG site: http://wiki.ros.org/ROS/Tutorials 


A The tutorials at this site and many other tutorials should probably be called “ROS tutorials 
for those familiar with Ubuntu, Python or C++, and ROS itself". Check to see that the references 
or books cover your version of the software. 


The textbook Learning ROS for Robotics Programming by Aaron Martinez is useful. The 
examples are in C++. 


A Gentle Introduction to ROS by JasonM. O'Kane is very readable and can be downloaded from 
the site: http://www.cse.sc.edu/~jokane/agitr/agitr-letter.pdf 


ROS Workspace 


The files for ROS and Rethink Baxter examples are downloaded into the ROS workspace when 
the system is created by downloading the software from the GitHub repositories. The instructions 
from Rethink Robotics are located at the web site: 


http://sdk.rethinkrobotics.com/wiki/Workstation Setup 


The setup procedure is not discussed here as it is assumed that this Introduction to Baxter will be 
used by those whose system is installed. 
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The command that causes communication between the workstation and Baxter is invoking the 
Baxter shell from the terminal window with a command such as: ./baxter.sh 


The result would indicate Baxter’s IP address, the user, and that the current directory is ros_ws in 
the example from Baxter’s lab at UHCL: 


[baxter - http://172.29.64.200:11311] tlharmanphd(8D125-43873:"/ros wsS 


Baxter is now ready to execute user commands. 


A The examples described in this report are from the UHCL Baxter lab. Any other setup of 
the Baxter software possibly would use different names for the directories, different IP addresses 
and certainly different user names for logging in to the system. These details must be determined 
by the system administrator who setup the system. 


Details about linking the workstation and Baxter are describe in this Rethink document: 


http://sdk.rethinkrobotics.com/wiki/Networking 


It is intended for those who understand networks and ROS Naming Conventions. For advanced 
users, the ROS tutorial might be helpful: http://wiki.ros.org/ROS/NetworkSetup 
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UBUNTU AND BASH 
Borrowing from Wikipedia, the free encyclopedia: 


Ubuntu (/u: bu:ntu:/ oo-BOON-too) is a Debian-based Linux operating system, with Unity as its default 
desktop environment (GNOME was the previous desktop environment). It is based on free software and 
named after the Southern African philosophy of ubuntu (literally, "human-ness"), which often is 
translated as "humanity towards others" or "the belief in a universal bond of sharing that connects all 
humanity". http://en.wikipedia.org/wiki/Ubuntu (operating system 


There are so many books, articles, videos and other references to Ubuntu or Linux or Unix as 
operating systems that the list would be longer than this report. Here is a downloadable, 
reasonably readable reference with the advantage it is only 143 pages long! 


Getting Started 
with Ubuntu 14.04 


Figure 18 Getting Started with Ubuntu 14.04 


http://files.ubuntu-manual.org/manuals/getting-started-with- 
ubuntu/14.04/en US/screen/Getting9620Started9620with9620Ubuntu962014.04.pdf I 


A A beginners question is surely “How much Ubuntu do I need to use Baxter?” Good 
question! A system administrator needs knowledge of user accounts and permissions. Also, some 
software downloads require administrator privilege. Fortunately, a user of Baxter can forgo the 
extensive study needed to be proficient in OS techniques. This report concentrates on users, NOT 
administrators. 


Of course, any user would need to create directories if not created by the Administrator, use 
editors to create programs and save the programs, list files in a directory, look up information on 
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the web, print text, and generally use the workstation efficiently. The Ubuntu system has two 
interfaces for the user, one graphic called the Unity Interface and one command line interface 
called the Terminal Interface. 


Unity Interface 


The most convenient interface for a casual user is the Unity desktop. It is a graphical user (GUI) 
interface that will not be strange to Windows users or especially MAC OSX users. 


This article on the WEB is useful for beginners: 


How to Master Ubuntu’s Unity Desktop: 8 Things You Need to Know 
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Figure 19 Unity Desktop 


The Unity user interface consists of several components: 


e Top menu bar — a multipurpose top bar, saving vertical space, and containing: (1) the 
menu bar of the currently active application, (2) the capture bar of the main window of 
the currently active application including the maximize, minimize and exit buttons, (3) 
the global system pulldown menu including the global system settings, logout, shut down 
and similar basic controls, and (4) the small icons that indicate the time, sound control, 
wi-fi signal strength, the user and perhaps other information. 


e Launcher — a dock on the left side vertically that also serves as a window switcher. Click 
on an icon to execute the application. Frequently used applications should be pinned to 
the Launcher by moving their icon from the desktop to the Launcher bar. The “Trash” 
icon at the bottom of the Launcher serves to hold deleted files and documents. 
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In Figure 19, the first five applications from top to bottom of the launcher are as follows: 


Dash — an overlay that allows the user to search quickly for information both locally (installed 
applications, recent files, bookmarks, etc.) and remotely (Twitter, Google Docs, etc.) and 
displays previews of results. 


File Manager - lists and allows navigation to various directories including the File System, 
Documents, Pictures, etc. The file manager shows the root (/) folder, the home folder for the user 
and the home folder for the system. Here is a description of some of the root directories for 
Ubuntu 10.04 — an older version than we are using: 


https://help.ubuntu.com/10.04/installation-guide/amd64/directory-tree.html 


A Be careful with documentation for any software module because all of the software described in 
this report is subject to updating by the organizations or individuals that maintain the software. 


Mozilla Firefox — the WEB browser useful for searches using Google and bookmarking relevant 
documents for Baxter. One of the first sites to bookmark is the ^wiki/Main Page" from Rethink 
Robotics: 


http://sdk.rethinkrobotics.com/wiki/Main Page 


This is the research Baxter's main information page which is invaluable for setting up Baxter and 
using the Baxter Examples provided by Rethink. 


LibreOffice and LibreOfficeCalc - word processing and spreadsheet programs compatible 
with Word and Excel. 


Explore the other icons used for software downloads, system settings and other applications. 


Many normal operations can be performed using the Unity GUI desktop. Folders can be created 
in any directory by Right Clicking in the directory opened in the File Manager and using the 
drop down menu and selecting Create New Folder, for example. There is a search option in the 
File manager also. If an external USB device is connected such as a memory stick, its icon will 
be displayed in the list of files and on the Launcher dock. 
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Terminal Interface 


For Baxter users, the terminal interface is the most important interface on the desktop. If it is not 
installed, activate the Dash, search for “terminal” and drag the icon to the desktop and then to the 
launcher. 


Here is a reference that may be of questionable use to a beginner 


https://help.ubuntu.com/community/UsingTheTerminal 


There are a number of basic tutorial videos on YouTube. For example, 


Ubuntu 12.04 Terminal Tutorial #1 by Nicholas Lindsay: 


http://www.youtube.com/watch?v=Uabfu_RJLyg On that page are many other tutorials. 


Some examples that compare Unity GUI commands with Terminal commands are shown in 
Appendix II. 


The terminal commands are used as follows by Baxter users depending on their familiarity with 
Ubuntu and the terminal shell: 


1. Perform all the usual operations expected of an operating system such as creating 
directories, files, documents, etc. 


2. Create programs (scripts) that will command Baxter. There are text editors such as gedit, 
emacs or vi for this purpose. These editors do not insert any fancy formatting commands 
in the text. 


3. Allow communication between Ubuntu, ROS, and Baxter as needed. For example, a 
command to enable Baxter would be typed on the terminal as 


$ rosrun baxter tools enable robot.py —e 


The $ is the command prompt. When the command is executed, ROS executes the 
Python script enable robot.py from the package baxter. tools. The Baxter Python 
programs and their connection to Baxter are discussed later. 


4. Allow users to download software for Baxter or ROS that does not require administrative 
privileges. System administrators normally use the terminal commands for setting up and 
maintaining the system by installing and updating software. 


A This site is a good tutorial for those beginning to use the Ubuntu terminal commands. 
Note that different versions of the OS may have slightly different command formats. 


"A beginners guide to the Unix and Linux operating system. Eight simple tutorials which cover 
the basics of UNIX / Linux commands". http://www.ee.surrey.ac.uk/Teaching/Unix/ 
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What is BASH ? 


Bash is the shell, or command language interpreter, for the GNU operating system. The name is 
an acronym for the ‘Bourne-Again SHell',apun on Stephen Bourne, the author of the 
direct ancestor of the current Unix shell sn, which appeared in the Seventh Edition Bell Labs 
Research version of Unix. 


http://www.gnu.org/software/bash/manual/bash.html 


Basically, a shell is simply a macro processor that executes commands. The term macro 
processor means the text and symbols of a command are expanded to create larger expressions. 


A Unix shell is both a command interpreter and a programming language. As a command 
interpreter, the shell provides the user interface to the rich set of GNU utilities’. The programming 
language features allow these utilities to be combined. Files containing commands can be 
created, and become commands themselves. These new commands have the same status as 
system commands in directories such as /bin, allowing users or groups to establish custom 
environments to automate their common tasks. 


Shells may be used interactively or non-interactively. In interactive mode, they accept input 
typed from the keyboard. When executing non-interactively, shells execute commands read from 
a file. 


For advanced Baxter users, Baxter can be controlled by "shell scripts" which are simply 
programs that execute ROS commands or Rethink Baxter Examples when invoked. Fortunately, 
for those who are content running Baxter commands one by one from the terminal window's 
command line, there is little need to learn Bash scripting. The Rethink Baxter Examples are 
discussed in the separate report Baxter User 's Guide. 


The shell has a number of ways to obtain help for a command including the commands: 


info, man, -h, --help 


According to the The Linux Information Project website:  http://www.linfo.org/man.html 


“The man pages are a user manual that is by default built into most Linux distributions (i.e., 
versions) and most other Unix-like operating systems during installation. They provide extensive 
documentation about commands and other aspects of the system, including configuration files, 
system calls, library routines and the kernel (i.e., the core of the operating system). A 
configuration file is a type of simple database that contains data that tells a program or operating 
system how to behave. A system call is a request made via a software interrupt (i.e., a signal to 
the kernel initiated by software) by an active process for a service performed by the kernel. A 
library routine is a subprogram that is used by programmers to simplify the development of 
software". 


? https://www.gnu.or 
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A “The descriptions are rather terse, and they can seem somewhat cryptic to new users. 


However, users typically find them to be increasingly useful as they become more familiar with 


them and gain experience in the use of Unix-like operating systems"? 


Bash confusion 


As expected, there are many tutorials that cover the BASH shell. Here is one with a few of the 
comments from the site. For example, Bash by Example 


http://www.ibm.com/developerworks/library/l-bash 


A “Learning bash the wrong way can be a very confusing process. Many newbies type "man 
bash" to view the bash man page, only to be confronted with a very terse and technical 
description of shell functionality. Others type "info bash" (to view the GNU info 
documentation), causing either the man page to be redisplayed, or (if they are lucky) only 


slightly more friendly info documentation to appear. 


While this may be somewhat disappointing to novices, the standard bash documentation can't be 
all things to all people, and caters towards those already familiar with shell programming in 
general. There's definitely a lot of excellent technical information in the man page, but its 
helpfulness to beginners is limited”. 


This warning to new users should not discourage them from working with the shell and its 
commands. Don’t expect instant success if you are accustomed only to the GUI interfaces of 
Operating Systems. 


3 Sorry to be flippant but | am reminded of the advertisements for “Weight Loss Pills”. They work when combined 
with a sensible regime of diet and exercise! If | followed their directions why would | need the pills. 
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CONCLUSIONS 


If you have managed to review this Introduction to Baxter, you could benefit from reviewing 
some of the documentation on the Rethink Robotics wiki site. 


The “Learning” page appears as follows http://sdk.rethinkrobotics.com/wiki/Learnin 


Learning 


Discussion 


Navigation Advanced 7 " J 
Getting Started Foundations Understanding Tools Configuration/Admin 


Learning 

Community 

Support 
Links 


Tools 


Further Understanding Setup, System Admin & 


SDK Foundation External Tools 


& Advanced Concepts Maintenance 
i Operational Tools Robot Configuration 
First Steps ; 
Writing Pr Conceptual Overview External Tools Software Updates 
ng dx Baxter Platform Supported ROS Tools Maintenance/Debug Tools 
Robot Foundations 
R Advanced Concepts Resources Resources 
Sources ROS Tools Links System Info 


4 Rethink Robotics. All rights reserved. SpecialPages Privacy policy About sdk-wiki Disclaimers 


| http://sdk.reth nkrobotics.com/wiki/Advanced_Understanding 


Figure 20 Rethink Robotics Learning Page 
Each link on the page leads to expanded explanations of any item. 


The “Foundations” page discussed Baxter applications in some detail. Many of the items presented 
there will be explained in our Baxter User s Guide. 


http://sdk.rethinkrobotics.com/wiki/Foundations 


For those new to Baxter, the Rethink documentation should be used “many times” as each time new 
information becomes apparent and previous descriptions become clearer. In Baxter’s Lab, a 
combination of reviewing the documentation and using Baxter has led to a good understanding of 
Baxter’s capabilities. 
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APPENDIX I Baxter Specifications 


1.1 Specification: 


PHYSICAL SPECIFICATIONS 


Robot Height 


Arm Length to End Effector Plate 


Torso Mounting Plate Diameter 


Body weight 


Degrees of Freedom 


Pedestal Footprint 


Max Pay Load (Including End Effector) 


Gripping Torque (Max) 


3’ 1” without pedestal 
5' 10” — 6 '3" with adjustable pedestal (optional) 


41" 


13.3" (for mounting on table) 


165 Ibs. without pedestal 
306 Ibs. with pedestal (optional) 


14 (7 per arm) 


36" x BD? 


5 Ib/2.2 kg 


10 Ib /4.4 kg 
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COMPUTER & SENSOR SPECIFICATIONS 


Processor 


Memory 


Storage 


Camera Max Resolution 


Camera Effective 
Resolution 


Camera Frame Rate 


Camera Focal Length 


Screen Resolution 


Infrared Sensor Range 


3rd Gen Intel Core 17-3770 Processor (8MB, 3.4GHz) w/HD4000 
Graphics 


4GB, NON-ECC, 1600MHZ DDR3 


128GB Solid State Drive 


1280 x 800 pixels 


640 x 400 pixels 


30 frames per second 


1.2 mm 


1024 x 600 pixels 


1.5—- 15 in / 4 — 40 cm 
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ELECTRICAL SPECIFICATIONS 


Supply Voltage 


Rated Current 


Battery 
Operation 


Interface 


Max 
Consumption 


Maximum 
Efficiency 


Power Supply 


Tolerance to Sags 


Voltage Flicker 


Voltage 
Unbalance 


120 volts alternating current 


6 amps 


DC-to-120V AC Inverter (Note: the Baxter robot has an internal PC, which cannot 
be powered directly off of 24V DC) 


Standard 120VAC power. Robot power bus and internal PC both have “universal” 
power supplies and support 90 — 264V AC (47 — 63Hz) 


6A at 120V AC, 720W max per unit 


87% to 92% 


Uses medical-grade DC switching power supply for robot power bus 


Sags tolerated to 90V. Sustained interruption will require manual power-up 


Holdup time 20mS 


Single phase operation only 
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WORKSTATION REQUIREMENTS 


Baxter Research Robot requires a workstation (not included) that meets the following 
technical specifications: 


Software Ubuntu 10.4 LTS and ROS Electric - Upgraded to 12.04 LTS and ROS Indigo- 2015 
Processor Intel 15 or above 
Memory 4GB or more 


Free Disk 2GB or more 
Space 


Connectivity Ethernet port 
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APPENDIX II Unity and Terminal Commands 


Comparison of Unity GUI commands and Terminal commands 


UNITY EXAMPLES TERMINAL EXAMPLES 
GENERAL HELP 
Dash Help ? Desktop Guide cmd! --help cp —help 
help cmd help pwd 

Fl — Works with many man cmd man echo 

applications whatis cmd whatis grep 

info cmd info grep 
FILES DIRECTORIES 
Home Folder -File Show Is -la Show all and long- 
System Root/home/home-user permissions, etc. 
RightClick Copy cp <options> filel file2 | Copy -r does files in 
Then Paste directories 

EDITOR 
LibreOffice Save as txt if a gedit file Move up to menu bar 

program- change suffix and File:SaveAs 
SYSTEM 
Sysinfo in Dash (Installed) -Hardware — |Ispci -v More information than 
SystemSettings-Launcher | Appearance, HW, you need 

or on Right of menu bar | Network...,details, User 

Accounts 
NETWORK 
SystemSettings Network |172.29.64.201 ifconfig 


1 Here cmd means any valid command such as Is 
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